home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / calls11.zip / CALLS.DOC < prev    next >
Text File  |  1993-02-20  |  10KB  |  227 lines
  1.             ┌──────────────────────────────────────────────────┐
  2.             │            Caller Log    Version 1.1             │
  3.             │        Copyright  1993 -*- GlassWare Doors       │
  4.             ├──────────────────────────────────────────────────┤
  5.             │  Written in Turbo Pascal By:  H. Allen Cravener  │
  6.             └──────────────────────────────────────────────────┘
  7.  
  8.      First the legal stuff:
  9.  
  10.      This Program is Shareware. This means that if you find it useful you
  11.      Must register it if you are going to continue using it.
  12.  
  13.      You may try it for 30 days to determine whether it is a program that
  14.      you consider helpful and worth paying for.  After 30 days you must
  15.      either send my fee or delete it from your hard drive.
  16.  
  17.      You may distribute this software by uploading it to any BBs that you
  18.      call.  You also may pass it along to a friend.
  19.  
  20.      You may NOT charge anything for this utility and you may not include
  21.      it as part of any software that you are selling.  If you like it and
  22.      find it useful, you might let me know.  That would encourage me to
  23.      write some more when the need arises.
  24.  
  25.      This Program was tested on my BBs:  (Wildcat 5.55M)
  26.  
  27.      If you like the Program and continue using it then you MUST send me
  28.      $15.00 (Cheap huh?) to encourage me to continue writing BBS Utilities.
  29.  
  30.                         ┌──────────────────────────┐
  31.                         │  The Glass Menagerie II  │
  32.                         │      (215)376-1819       │
  33.                         │ 1200/2400/16800  V32.bis │
  34.                         └──────────────────────────┘
  35.  
  36.      I do not guarantee that this Program will work for you, nor will I be
  37.      responsible for any damage that may result from using this utility.
  38.      It is your responsibility to test it with your system and determine
  39.      that it will cause no harm.
  40.  
  41.      How does it work:  (EASY AS 1 2 3)
  42.  
  43.      1: Place CALLS.EXE in your Wildcat 'HOME' Directory. IE: c:\wc30.
  44.      2: Create a CALLS.CFG file (see example below).
  45.      3: Add a couple of short lines to your POSTCALL.RUN file in 'EACH'
  46.        NODES wc30\wcwork\node# directory.  (see example below).
  47.  
  48.                           *** What will it do ***
  49.  
  50.     CALLS.EXE (when run from your POSTCALL.RUN) on each node, will create
  51.     a BULL#.BBS that will display who called today.  Included in this BULL
  52.     will be all callers names, where from, connect speed, uploads,
  53.     messages posted, downloads, when connected, and how long online.
  54.     Callers who have dropped carrier will also be noted with an * .
  55.  
  56. PAGE 1
  57.  
  58.  
  59.     There will be a summary of activity for all nodes printed as the
  60.     last screen in the bulletin.  It will contain totals for all above
  61.     info. as well as total local logons, percentage of utilization, and
  62.     number of new users.
  63.  
  64.     When the date changes at midnight, CALLS.EXE will know it and create a
  65.     second bulletin that will then be your log of who called yesterday.
  66.     This is automatic and requires no special commands or events.
  67.  
  68.  
  69.     The number of nodes that you want to report is selected in the CONFIG
  70.     file, and should handle any number of nodes (tested on 4 nodes).
  71.     CALLS.EXE fully supports file locking and should work fine on any
  72.     multi-node Wildcat system.  CALLS.EXE does not require SHARE to be
  73.     loaded, however it doesn't mind if it is.
  74.  
  75.     CALLS.EXE is very fast and will not slow down your bbs cycle for more
  76.     than a second or two per node (depending on how big your activity.###
  77.     files are.
  78.  
  79.     CALLS.EXE generates it's bulletins using the Wildcat @ codes for all
  80.     functions such as colors, cls, and pause.  You only need one bulletin
  81.     that way.  No need for separate BBS and SCR files.
  82.  
  83.     Single Node users should indicate 1 node in the CALLS.CFG file.
  84.  
  85.  
  86.                                <POSTCALL.RUN>
  87.  
  88.  
  89.     cd c:\wc30 <───────────┬────────────────────────────────────┐
  90.     CALLS.EXE  <──────┐    │FIRST change to the WILDCAT home    │
  91.                       │    │Directory. (complete drive/path)    │
  92.                       │    └────────────────────────────────────┘
  93.                       └────┬────────────────┐
  94.                            │Call CALLS.EXE  │
  95.                            └────────────────┘
  96.  
  97.     ┌────────┐    ┌───────────────────────────────────────────────┐
  98.     │        ├────┤ This is the required filename for your        │
  99.     CALLS.CFG     │ CALLS config file.  Nothing else will work.   │
  100.                   │ IT MUST be in the same directory as CALLS.EXE.│
  101.                   └───────────────────────────────────────────────┘
  102.  
  103.  
  104.     NOTE:  You can also call CALLS.EXE during your nightly event to update
  105.            your YESTERDAY bulletin.  The closer to 00:01 AM that you run
  106.            CALLS.EXE the more accurate your bullitens will appear.
  107.            However, it must be run:
  108.                          
  109.                  'AFTER THE DATE HAS CHANGED ON YOUR COMPUTER'!     
  110.  
  111.  
  112. PAGE 2
  113.  
  114.     Below find a sample CALLS.CFG file that you must create using a simple
  115.     (ctrl z terminated) ascii editor.
  116.  
  117.                      ┌───────────────────────────────────────┐
  118.    ┌─────────────────┤ This is the number of nodes that you  │
  119.    │                 │ want included in your bulletins.      │
  120.    │                 │ If your system is NOT multi-node then │
  121.    │                 │ you must enter 1 here.                │
  122.    │                 └───────────────────────────────────────┘
  123.    │                  ┌────────────────────────────────────────┐
  124.    │                  │ This is the COMPLETE path and filename │
  125.    │                  │ for your bulletin of todays calls.     ├───┐
  126.    │                  └────────────────────────────────────────┘   │
  127.    │                ┌──────────────┐ ┌──────────┐                  │
  128.    │               ┌┤ SysOp's Name │ │ BBS Name │                  │
  129.    │               │└──────────────┘ └────┬─────┘┌──────────────┐  │
  130.    │               │                      │      │Your          │  │
  131.    │               │                      │     ┌┤Registration  │  │
  132.    │               │           ┌──────────┘     ││Number or 0000│  │
  133.    │               └────────┐  │                │└──────────────┘  │
  134.    │   H. Allen Cravener <──┘  │┌───────────────┘                  │
  135.    │   The Glass Menagerie II <┘│ ┌────────────────────────────────┘
  136.    │   0000 <───────────────────┘ │ ┌───────────────────────────────┐
  137.    └─> 4                          │ │ This is the complete path and │
  138.        c:\wc30\bull\bull1.bbs <───┘ │ filename for your bulletin of │
  139.        c:\wc30\bull\bull2.bbs <─┐   │ yesterdays calls.             │
  140.        Thu, 01/21/1993 <─┐      │   └──┬────────────────────────────┘
  141.     ┌> ALLEN CRAVENER    │      └──────┘
  142.     ├> JOHN SMITH        │ ┌─────────────────────────────────────────┐
  143.     ├> HARRY JONES       └─┤ THIS IS IMPORTANT! Please place the     │
  144.     ├> TIM BRUBAKER        │ current date here.  Use  the same       │
  145.     │                      │ format that you see in the example.     │
  146.     │                      │ This line tells CALLS.EXE when the      │
  147.     │                      │ date has changed and triggers it to     │
  148.     │                      │ generate your bulletin of yesterdays    │
  149.     │                      │ calls.  (note 1 space between , and 01. │
  150.     │                      │ This date will then be maintained by    │
  151.     │                      │ CALLS.EXE after the initial setup.      │
  152.     │                      └─────────────────────────────────────────┘
  153.     │                      ┌──────────────────────────────────────────────┐
  154.     │                      │ Enter up to 10 names here to exclude from    │
  155.     │                      │ display in your todays calls and yesterdays  │
  156.     └──────────────────────┤ calls bulletin.  You do NOT need to enter    │
  157.                            │ your name if you log on locally since the    │
  158.                            │ program does NOT display the names of local  │
  159.                            │ logons.  If you log on a lot from remote     │
  160.                            │ then you might want to include your name     │
  161.                            │ in this list.                                │
  162.                            │ While these names will NOT be included in    │
  163.                            │ your bulletins, their activities will be!    │
  164.                            └──────────────────────────────────────────────┘
  165.  
  166.     Registered users must enter their name, and BBS name EXACTLY as they
  167.     gave it to me when they asked for their registration number.  Otherwise
  168.     their registration number will not work.
  169.  
  170.     Once you have registered this program you will be able to download and
  171.     register all future upgrades of this program with your registration
  172.     number.
  173.  
  174. PAGE 3
  175.  
  176.     If you have any questions, or suggestions, then please feel to give my
  177.     BBS a call and leave me a comment at (215) 376-1819 or I can also be
  178.     contacted at my office by calling (215) 376-7768
  179.  
  180.  
  181.     If mailing in your registration fill out the information below.
  182.  
  183.     Name: __________________________________________________________
  184.  
  185.     Address: _______________________________________________________
  186.  
  187.     City: ________________________ State: ____ Zip Code: ___________
  188.  
  189.     BBS Name: ________________________________________ 29 Chrs. Max.
  190.  
  191.  
  192.     Fill in the information below if you want t be pre-registered on my
  193.     bbs.  I will leave you a private message there with your registration
  194.     number in it.  OTHERWISE your registration number will be mailed to you
  195.     as soon as i get this registration and the check clears the bank.
  196.  
  197.     (With money order or cashiers check i will send number immediately)
  198.  
  199.  
  200.     Telephone number __________________ Date of Birth: _____________
  201.  
  202.     Password:____________
  203.  
  204.  
  205.     Your registration ($15.00)* should be mailed to:
  206.  
  207.                            ┌───────────────────┐
  208.                            │ H. Allen Cravener │
  209.                            │  1137 Cotton St.  │
  210.                            │    Reading Pa.    │
  211.                            │       19602       │
  212.                            └───────────────────┘
  213.  
  214.      * PA. Residents include 6%  ($.90) Sales Tax to total $15.90.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. PAGE 4
  227.